package com.cn.springcloudwechat.common.utils.weixin.api;

import java.io.UnsupportedEncodingException;

/**
 * 客户
 * @创建者 x.c
 * @地址 成都云函科技有限公司
 * @时间 2017年12月15日
 * @版本 v1.0.0
 */
public interface CustomerUserAPI {
	// 添加客服帐号(不能直接使用)
	static String add_customer = "/customservice/kfaccount/add?access_token=%s";
	// 把客户账号和微信账号绑定(邀请绑定客服帐号)
	static String binding_customer_weixin = "/customservice/kfaccount/inviteworker?access_token=ACCESS_TOKEN";
	//上传客户头像
	static String upload_customer_headurl ="/customservice/kfaccount/uploadheadimg?access_token=%s&kf_account=%s";
	//获取客户基本信息
	static String get_customer="/customservice/getkflist?access_token=%s";
	//修改客户昵称(设置客户信息)
	static String update_customer="/customservice/kfaccount/update?access_token=%s";
	/**
	 * 添加客户账号
	 * 
	 * @方法名:addCustomer
	 * @描述:
	 * @param kf_account
	 *            完整客服帐号，格式为：帐号前缀@公众号微信号，帐号前缀最多10个字符，必须是英文、数字字符或者下划线，后缀为公众号微信号，
	 *            长度不超过30个字符
	 * @param nickname
	 * @return
	 */
	String addCustomer(String kf_account, String nickname) throws UnsupportedEncodingException;

	/**
	 * 绑定客户到微信
	 * 
	 * @方法名:bindingCustmoerWeixin
	 * @描述:
	 * @param kf_account
	 *            完整客服帐号，格式为：帐号前缀@公众号微信号，帐号前缀最多10个字符，必须是英文、数字字符或者下划线，后缀为公众号微信号，
	 *            长度不超过30个字符
	 * @param invite_wx
	 *            接收绑定邀请的客服微信号
	 * @return
	 */
	String bindingCustmoerWeixin(String kf_account, String invite_wx) throws UnsupportedEncodingException;
	/**
	 * 上传客服头像
	 *@方法名:uploadCustomerHeadurl
	 *@描述:
	 *@param kf_account
	 *@param path
	 *@return
	 */
	String uploadCustomerHeadurl(String kf_account, String path);
	/**
	 * 获取客户头像
	 *@方法名:getCustomer
	 *@描述:
	 *@return
	 */
	String getCustomer();
	/**
	 * 修改客户昵称
	 *@方法名:updateCustomer
	 *@描述:
	 *@param kf_account
	 *@param nick_name
	 *@return
	 */
	String updateCustomer(String kf_account, String nick_name) throws UnsupportedEncodingException;

}
